home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / SgVisualDrawingArea.z / SgVisualDrawingArea
Text File  |  1998-10-30  |  18KB  |  265 lines

  1.  
  2.  
  3.  
  4.      VVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     VVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           SSSSggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa - A drawing area in an alternate visual
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ####iiiinnnncccclllluuuuddddeeee <<<<SSSSggggmmmm////VVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAA....hhhh>>>>
  13.  
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents the version of Sgm that accompanies
  17.           Motif 2.1.
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.           SSSSggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa is a subclass of the Motif Drawing Area
  21.           that allows has a visual resource, allowing the widget to be
  22.           placed into a visual different than the rest of the
  23.           application.  It is useful for applications that need to use
  24.           multiple visuals, for example, running one window in 24 bit
  25.           RGB while the rest of the application is in 8 bit pseudo
  26.           color.
  27.  
  28.           SSSSggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa also has the ability to create a
  29.           TrueColor dithered background to more closely match a
  30.           requested background, and to set the WM_COLORMAP_WINDOWS
  31.           property to have the window manager install its background.
  32.  
  33.           Since the SSSSggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa is a subclass of XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, it
  34.           can have children.  These children will automatically
  35.           inherit the visual, colormap, and depth of the
  36.           SSSSggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa.  Thus, the SSSSggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa can be
  37.           used to chage the visual of a hierarchy of widgets.
  38.  
  39.         CCCCllllaaaasssssssseeeessss
  40.           SgVisualDrawingArea inherits behavior and resources from
  41.           CCCCoooorrrreeee, XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, and XXXXmmmmDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa classes.
  42.  
  43.           The class pointer is ssssggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaaWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss.
  44.  
  45.           The class name is SSSSggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa.
  46.  
  47.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  48.           The following table defines a set of widget resources used
  49.           by the programmer to specify data.  The programmer can also
  50.           set the resource values for the inherited classes to set
  51.           attributes for this widget.  To reference a resource by name
  52.           or by class in a .Xdefaults file, remove the XXXXmmmmNNNN, SSSSggggNNNN, XXXXmmmmCCCC,
  53.           or SSSSggggCCCC prefix and use the remaining letters.  To specify one
  54.           of the defined values for a resource in a .Xdefaults file,
  55.           remove the XXXXmmmm prefix and use the remaining letters (in
  56.           either lowercase or uppercase, but include any underscores
  57.           between words).  The codes in the access column indicate if
  58.           the given resource can be set at creation time (C), set by
  59.           using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G),
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      VVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     VVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           or is not applicable (N/A).
  75.  
  76.                             SSSSggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  77.      NNNNaaaammmmeeee                  CCCCllllaaaassssssss                 TTTTyyyyppppeeee       DDDDeeeeffffaaaauuuulllltttt          AAAAcccccccceeeessssssss
  78.      ______________________________________________________________________________
  79.      SgNditherBackground   SgCDitherBackground   Boolean    False            CG
  80.      SgNinstallColormap    SgCInstallColormap    Boolean    False            CG
  81.      XmNvisual             XmCVisual             Visual *   CopyFromParent   CG
  82.  
  83.  
  84.           SSSSggggNNNNddddiiiitttthhhheeeerrrrBBBBaaaacccckkkkggggrrrroooouuuunnnndddd
  85.                     If the visual is a TrueColor or StaticColor
  86.                     visual, and the widget is unable to get an exact
  87.                     match for the requested background color, the
  88.                     widget will attempt to produce a dithered pixmap
  89.                     that produceds a closer background to that
  90.                     requested.  If it finds one, it will automatically
  91.                     set the XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnnddddPPPPiiiixxxxmmmmaaaapppp resource to this
  92.                     pixmap.  The resource is ignored in any other
  93.                     visual, or if XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnnddddPPPPiiiixxxxmmmmaaaapppp is already set.
  94.  
  95.           SSSSggggNNNNiiiinnnnssssttttaaaallllllllCCCCoooolllloooorrrrmmmmaaaapppp
  96.                     If true, specifies that the widget should set the
  97.                     WWWWMMMM____CCCCOOOOLLLLOOOORRRRMMMMAAAAPPPP____WWWWIIIINNNNDDDDOOOOWWWWSSSS property on the shell
  98.                     containing the widget, so that the window manager
  99.                     installs the colormap when that application gets
  100.                     focus.  At least one window using each colormap
  101.                     should be listed in this property (even if the
  102.                     widgets are TrueColor), although if several
  103.                     widgets share the same colormap it is only
  104.                     necessary to set this resource for one of them.
  105.                     If the application needs more direct control over
  106.                     when the colormaps are installed, this resource
  107.                     could be false.  In such a case,
  108.                     SSSSggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaaIIIInnnnssssttttaaaallllllllCCCCoooolllloooorrrrmmmmaaaapppp((((3333XXXX)))) and
  109.                     SSSSggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaaUUUUnnnniiiinnnnssssttttaaaallllllllCCCCoooolllloooorrrrmmmmaaaapppp((((3333XXXX)))) may be
  110.                     used instead.
  111.  
  112.           XXXXmmmmNNNNvvvviiiissssuuuuaaaallll Specifies the visual in which to create the
  113.                     window.  It must match the depth and colormap of
  114.                     the widget or a BadMatch error can result.
  115.  
  116.  
  117.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  118.           SgVisualDrawingArea inherits behavior and resources from the
  119.           following superclasses.  For a complete description of each
  120.           resource, refer to the man page for that superclass.
  121.  
  122.                               XXXXmmmmDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  123.      NNNNaaaammmmeeee                CCCCllllaaaassssssss             TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt        AAAAcccccccceeeessssssss
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      VVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     VVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa((((3333XXXX))))
  137.  
  138.  
  139.  
  140.      ____________________________________________________________________________
  141.      XmNexposeCallback   XmCCallback       XtCallbackList   NULL           C
  142.      XmNinputCallback    XmCCallback       XtCallbackList   NULL           C
  143.      XmNmarginHeight     XmCMarginHeight   Dimension        10             CSG
  144.      XmNmarginWidth      XmCMarginWidth    Dimension        10             CSG
  145.      XmNresizeCallback   XmCCallback       XtCallbackList   NULL           C
  146.      XmNresizePolicy     XmCResizePolicy   unsigned char    XmRESIZE_ANY   CSG
  147.  
  148.                                           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  149.      NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  150.      _________________________________________________________________________________________________
  151.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
  152.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  153.      XmNforeground           XmCForeground           Pixel               dynamic                CSG
  154.      XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
  155.      XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
  156.      XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
  157.      XmNinitialFocus         XmCInitialFocus         Widget              NULL                   CSG
  158.      XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  159.      XmNshadowThickness      XmCShadowThickness      Dimension           0                      CSG
  160.      XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
  161.      XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
  162.      XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
  163.      XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
  164.      XmNunitType             XmCUnitType             unsigned char       dynamic                CSG
  165.      XmNuserData             XmCUserData             XtPointer           NULL                   CSG
  166.  
  167.                              CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  168.      NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  169.      ______________________________________________________________________
  170.      XmNchildren         XmCReadOnly         WidgetList    NULL      G
  171.      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  172.      XmNnumChildren      XmCReadOnly         Cardinal      0         G
  173.  
  174.                                                    CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  175.      NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  176.      ______________________________________________________________________________________________________________
  177.      XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
  178.      XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  179.      XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  180.      XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  181.      XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  182.      XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  183.      XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  184.      XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  185.      XmNdepth                        XmCDepth                        int              dynamic                CG
  186.      XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  187.      XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  188.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  189.      XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                         (printed 10/24/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      VVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     VVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa((((3333XXXX))))
  203.  
  204.  
  205.  
  206.      XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  207.      XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  208.      XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  209.      XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  210.      XmNx                            XmCPosition                     Position         0                      CSG
  211.      XmNy                            XmCPosition                     Position         0                      CSG
  212.  
  213.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  214.           SSSSggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaaIIIInnnnssssttttaaaallllllllCCCCoooolllloooorrrrmmmmaaaapppp((((3333XXXX)))),
  215.           SSSSggggVVVViiiissssuuuuaaaallllDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaaUUUUnnnniiiinnnnssssttttaaaallllllllCCCCoooolllloooorrrrmmmmaaaapppp((((3333XXXX)))),
  216.           XXXXmmmmDDDDrrrraaaawwwwiiiinnnnggggAAAArrrreeeeaaaa((((3333XXXX)))),PPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX)))), CCCCoooorrrreeee((((3333XXXX))))
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                         (printed 10/24/98)
  262.  
  263.  
  264.  
  265.